Configuring IBM MQSeries as the Messaging Service for Process Platform

This topic describes the procedure to configure IBM MQSeries as the messaging service for Process Platform.

When a Service Container is created, a connection point is configured for the Service Container to receive SOAP requests and to respond to them. Process Platform provides Java Message Service (JMS) as one of the types of connection points. The list of vendors for JMS includes IBM MQSeries. This topic describes the procedure for configuring IBM MQSeries as the messaging service when using JMS as the type of connection point.

1. Create a local queue from IBM WebSphere MQ Explorer.
2. Run the JMSAdmin tool.
   Make the following changes in the JMSAdmin.config file before running the JMSAdmin tool.
   
   
   • UncommentINITIAL_CONTEXT_FACTORY=com.sun.jndi.fscontext.RefFSContextFactory
   • Comment all other lines starting withINITIAL_CONTEXT_FACTORY.
   • UncommentPROVIDER_URL=file:<MQSeries installation directory>.
   • Comment all other lines starting withPROVIDER_URL.
   • Ensure that all JAR files available at <drive name>:\Program files\IBM\WebSphere MQ t_en_us_\MSI\Program Files\IBM\WebSphere MQ\Java\lib are specified in classpath.
     The JMSAdmin.config file and the JMSAdmin tool are available at <drive name>:\Program files\IBM\WebSphere MQ t_en_us_\MSI\Program Files\IBM\WebSphere MQ\Java\bin\JMSAdmin.bat.
     
     To run the JMSAdmin tool, run the following commands:
   1. InitCtx> DEFINE Q(<name of the JMS queue>) QUEUE(<name of the MQSeries queue>)
   2. InitCtx> DEFINE QCF(<name of the queue communication factory>)
3. Create a Service Container using the System Resource Manager task.
   In the Provide Connection Point Details window, do the following:
   
   
   1. Type the name of the connection point.
   2. Select JMS in the Type region.
   3. Select IBM MQSeries as the JMS vendor.
   4. In the Provider URL box, enter the URL of the MQSeries installation directory.
   5. In the Factory box, enter the name of the queue connection factory.
   6. In the Queue box, enter the name of the JMS queue.
   7. Select the authentication type to determine the security level of the messaging service. If you select an authentication type other than None, then provide the user name and password of the user who can access this messaging service.
4. Test the messaging service.
   To test whether the messaging service is working, do the following:
   
   
   1. Start the Service Container from the Services pane in System Resource Manager window.
   2. Start Simple Client from Start > Programs > <Process Platform Version> > Instance Name > Tools > Simple Client
   3. Send some SOAP requests using Simple Client, and check whether the Service Containers sends the responses.
   4. To test the asynchronous communication, stop the Service Container and send some requests using Simple Client. Check whether the requests are stored in the IBM MQSeries queue. On restarting the Service Container, it receives the requests from the queue and responds to them.